home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / gfx / show / tapdl13.lha / makedl.man < prev    next >
Text File  |  1994-11-30  |  5KB  |  156 lines
  1.  
  2.  
  3.  
  4.     MAKEDL 1.1                                                30.11.94
  5.  
  6.  
  7.  
  8.     ABOUT
  9.  
  10.     This is a CLI-based DL animation creator for machines with KS 2.0
  11.     or better. It creates version 2 DL files based on a script that
  12.     you give it, much like MKANIM and similar programs.
  13.  
  14.     DL files are a kind of animation once found only on PCs. The
  15.     animations are either 320x200, 160x100, or 80x50, in 256 colors.
  16.     The colors are 18 bits each, 6 per gun.
  17.  
  18.     MAKEDL is Copyright © 1994 by John Bickers.
  19.  
  20.  
  21.     REQUIREMENTS
  22.  
  23.     MAKEDL requires a machine with at least KS2.0, and Christian
  24.     Weber's IFF library. The IFF library can be found on the Aminet
  25.     sites, and has to be no older than version 22.
  26.  
  27.  
  28.     PARAMETERS
  29.  
  30.     The command template is:
  31.  
  32.     DL/A,SCRIPT/A,24BIT/S
  33.  
  34.     The DL option is the name of the DL file you want to create, and
  35.     must be present.
  36.  
  37.     The SCRIPT option is also required, and is the name of the script
  38.     file that will define what goes into the animation. The script
  39.     file format is described below.
  40.  
  41.     The 24BIT option lets you force the palette in the DL file to be
  42.     a 24-bit palette. The format really wants an 18-bit palette, but
  43.     the TAPDL player on the Amiga is capable of handling both. Be
  44.     warned that an animation with a 24-bit palette will NOT play back
  45.     correctly on a PC, and I don't think that the difference in color
  46.     quality is really worth the hassle.
  47.  
  48.  
  49.     SCRIPT FILE FORMAT
  50.  
  51.     A script file is a simple text file containing a number of lines
  52.     of the form "<item> = <value>". The items are...
  53.  
  54.     title       A title for the animation. This has a maximum length
  55.                 of 20 characters.
  56.  
  57.     author      The author of the animation. Put your name here. This
  58.                 field also has a maximum length of 20 characters.
  59.  
  60.     model       This is a number, either 0, 1 or 2. These represent
  61.                 the dimensions of the animation, either 320x200,
  62.                 160x100, or 80x50 respectively.
  63.  
  64.     frame       The name of the IFF file containing a frame of the
  65.                 animation. There can be more than one frame field, and
  66.                 they should appear in the same order that you will
  67.                 index them in the command field. The dimensions of
  68.                 each frame should match the dimensions you select with
  69.                 the model field, but this isn't totally necessary. The
  70.                 IFF library tries to clip or pad bitmaps as required.
  71.  
  72.     command     A command sequence for controlling the playback of the
  73.                 animation. This is a list of values seperated by
  74.                 commas, where a value can be one of...
  75.  
  76.                 1.  A frame index, counting from 0. The frame you
  77.                     select will be the frame displayed at this point,
  78.                     with a default delay of 15/100ths of a second
  79.                     between frames.
  80.  
  81.                 2.  A loop indicator, L<N>, where N is the number of
  82.                     times that the loop should be executed. Note that
  83.                     the entire animation will loop ad infinitum, so an
  84.                     L<N> is only required for sub-loops.
  85.  
  86.                 3.  An end-of-loop indicator, E.
  87.  
  88.                 4.  A pause indicator, P<N>, where the pause will be
  89.                     N/100ths of a second long.
  90.  
  91.     As a test, I created 6 160x100/8 brushes that scrolled down the
  92.     centre of a picture (debanimation). The script file to create a DL
  93.     anim from these brushes looked like...
  94.  
  95.                 title = TEST ANIM
  96.                 author = John Bickers
  97.                 model = 1
  98.                 frame = suelin1.iff
  99.                 frame = suelin2.iff
  100.                 frame = suelin3.iff
  101.                 frame = suelin4.iff
  102.                 frame = suelin5.iff
  103.                 frame = suelin6.iff
  104.                 command = 0,1,2,3,4,5,4,3,2,1
  105.  
  106.  
  107.     CREDITS
  108.  
  109.     MAKEDL is written by John Bickers using SAS C 6.51.
  110.  
  111.     The DL file format and PC programs were created by Davide Tome'
  112.     and Luca De Gregorio. The format of a DL file was obtained by
  113.     looking at sample files, and running Davide and Luca's DL-VIEW.EXE
  114.     under Microsoft's CodeView debugger.
  115.  
  116.     Thanks to Christian Geisert for a variety of sample files.
  117.  
  118.     Christian A. Weber's iff.library is used for loading ILBM files.
  119.  
  120.  
  121.     DISTRIBUTION
  122.  
  123.     MAKEDL is Copyright © 1994 by John Bickers.
  124.  
  125.     Distribution is via normal channels. That is, distribute it for
  126.     free or for Fred Fish like costs, but not more. And remember to
  127.     include the documentation.
  128.  
  129.     If you use this program, I'd be keenly interested in a copy of the
  130.     animations that you create. I'm also interested in any suggestions
  131.     that you may have for making this program easier to use.
  132.  
  133.  
  134.     CONTACT INFO
  135.  
  136.     I can be reached at:
  137.  
  138.         John Bickers
  139.         214 Rata St
  140.         Naenae
  141.         New Zealand
  142.  
  143.     Or: jbickers@templar.actrix.gen.nz
  144.  
  145.  
  146.     DISCLAIMER
  147.  
  148.     It works on my machine.
  149.  
  150.  
  151.     HISTORY
  152.  
  153.     94.07.25    Created 1.0.
  154.     94.11.19    1.1.
  155.                 Fixed bug where CLI arguments weren't being freed.
  156.